home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,401 to 4,500 / aol-file-protocol-4400-4401-to-4500.zip / AOLDLs / PDA-Newton Development / ND Newt Development Environm / newt-devenv-31.sit / intro.txt < prev    next >
Text File  |  1995-08-11  |  11KB  |  232 lines
  1. intro.txt
  2. 8/11/95
  3. Newt 3.1
  4. (c) 1993, 1994, 1995, S. Weyer, All Rights Reserved Worldwide.
  5. weyer@netaxs.com
  6.  
  7. - Introduction
  8. - Newt in the News
  9. - For Further Info
  10. - Programming WARNING -- Newt and You
  11. - NewtonScript
  12. - Personal History, Credits
  13.   
  14.  
  15. Read Newt.1st first.
  16.  
  17. Copyright S. Weyer 1993, 1994, 1995, All Rights Reserved Worldwide.
  18.  
  19. Newt is shareware. It may be freely distributed via online services and
  20. bulletin boards if it is unmodified and includes the files described in
  21. Newt.1st. It may not be commercially bundled or redistributed on CD-ROM,
  22. floppy disk, PCMCIA, networks or other media without my permission. Please
  23. continue reading for help, examples, warnings and other information.
  24.  
  25. =====
  26. Introduction
  27.  
  28. Newt allows you to developing applications using NewtonScript, run and test
  29. it, and save it as a packagte directly on your Newton.
  30.  
  31. NewtonScript (NS), Newton's built-in, object-oriented (o-o) language, shares
  32. ancestry with dynamic o-o languages like Smalltalk, Self, Common Lisp, and
  33. ObjectLogo. NewtonScript is the same language that is used by Apple's Newton
  34. ToolKit (NTK). For more advanced users, familiarity with o-o concepts and
  35. constructs would be useful; for others, Newt should serve as a brief
  36. introduction to these ideas.  There is some information on NewtonScript
  37. here, and more in the Newt manual (available to registered users).
  38.  
  39.  
  40. Newt 1.0, the first version of Newt, was a turtle-graphics environment (this
  41. is available now via an optional NewtDraw plug-in -- see turtle.txt).
  42.  
  43. Newt 2.0 introduced rudimentary capabilities to create dynamic views and
  44. stand-alone applications that could later be run or transferred using RUNewt
  45. [no longer needed]. Users interested in building applications could consider
  46. Newt a portable prototyper, or as a learning step toward building more
  47. complex, complete and industrial-strength applications via NTK on Macintosh
  48. (and eventually Windows). See examples.txt for a list applications that can
  49. be built in Newt (and that are available to registered users).  See Getting
  50. Started in using.txt.
  51.  
  52. Newt 3.0 provides the ability to create real packages directly on the Newton
  53. (this requires the NewtPack plug-in -- see packages.txt).
  54.  
  55.  
  56. =====
  57. Newt in the News
  58.  
  59. Newt 1.0 received an early positive review in the first issue of the (now
  60. defunct) DoubleTap newsletter. "Building Native Newton Applications with
  61. Newt" appeared in PIE Developers, Vol. 2.4, July 1994; pp.14-18.  Erica Sadun
  62. reviewed Newt's turtle personality in the same issue. _protoReality 1.3 --
  63. the NANUG newsletter, available as a Newton book -- features an interview
  64. about Newt. _protoReality 1.3 & 1.4 have articles with my daughter on using
  65. Newt to draw letters.  Serg Koren has posted a Newt 2.4 review (in Paperback
  66. format) to newton.uiowa.edu/submissions, CIS, AOL and eWorld; it's available
  67. on the World Wide Web via:
  68.   http://www.netaxs.com/~archimag/revw.html
  69.  
  70. "Newt" is often used by the monosyllable-challenged to refer to a Newton.
  71. "Newt is neat" could refer to the Newton itself and/or to this wonderful
  72. application -- I will always mean the latter. Show Newt to your friends to
  73. help achieve the worldwide goal of "Newt on every Newt"! So that Newt can
  74. appeal to many families and orientations, it is gender "newtral" (in order to
  75. reproduce more Newts, however, it has not been "newtered"); users should
  76. probably not call themselves "newtists".
  77.  
  78. In other literary references, there is of course Shakespeare's famous drink
  79. recipe: "eye of newt, ...". For crossword puzzle fans, "eft" is an old term
  80. for "newt". Newts have hatched aboard the space shuttle ╤ "one small step for
  81. a newt, a giant leap for newtkind". Tabloids will probably suggest a
  82. connection between Newt and Elvis. This is likely, given Elvis' early career
  83. as a "lounge lizard". However, the FBI has conspiratorially censored this
  84. from the latest Newton ROMs [in early Newtons, you could set the Country
  85. field of your Personal Preferences to Graceland, though this "Easter Egg"
  86. could later interfere with dialing. A picture of a newt reappeared briefly
  87. whenever you woke up your Newton. Other wakeup pictures can be obtained by
  88. adding two or three spaces after your Address]. You should discount any
  89. tabloid allegations suggesting any relation between Newt, football great
  90. Knute Rockne, Newt, Wayne Newton, Olivia Newton-John, Newton Minnow, or last,
  91. but not least, U.S. Speaker of the House Newt Gingrich.
  92.  
  93.  
  94. =====
  95. For Further Info
  96.  
  97. Since I provide little description of Newton syntax, other functions, or
  98. curriculum ideas in this introductory file, I strongly recommend that you
  99. stay reasonably close to the examples that I provide, register Newt to obtain
  100. a more detailed manual and sample sources, wait for NS books to be published
  101. (there is an introductory book by McKeehan&Rhodes for $30 with demo version
  102. of Mac NTK), and/or buy the NTK and docs from APDA for $300. Take a look at
  103. the NewATut and NewtTurT Newton books, which are interactive tutorials. PDA
  104. (formerly PIE) Developers magazine is a source of practical programming
  105. information and examples (cds@netcom.com).  Join the NANUG user group -- fun
  106. and useful (marku@aix3.ema.com).
  107.  
  108. >> See newt-faq.txt for Frequently Asked Questions about Newt, NTK, etc.
  109.  
  110. >> See register.txt for Registration information/form
  111.  
  112. >> See examples.txt for Current List of 165+ Examples
  113.  
  114. >> See using.txt for information on installing and using Newt
  115.  
  116. >> See changes.txt for revision history and possible future features
  117.  
  118. >> See my home page for the latest info:  http://www.netaxs.com/~weyer
  119.  
  120. >> Contact weyer@netaxs.com if you have further questions
  121.  
  122.  
  123. =====
  124. Programming WARNING -- Newt and You
  125.  
  126. Exploring "mathematics microworlds" and doing problem solving by writing
  127. programs are "powerful ideas" (Seymour Papert) and require some active
  128. participation by you the learner -- taking risks and making mistakes. For
  129. example, Newt allows you to execute arbitrary NewtonScript expressions. This
  130. can be a formula for enlightenment or disaster. So, remember that this is
  131. your Newton with your information and listen to your mother's advice about
  132. backing up your system and hanging out with strange functions.
  133.  
  134. Using common sense in following examples and suggestions, and limiting
  135. yourself to documented commands, you should reap many benefits and long hours
  136. of enjoyment from using Newt. At the same time, "a little learning [about
  137. programming] is a dangerous thing" (with apologies to Alexander Pope). I
  138. would caution against experimenting with random functions or methods. "Gee, I
  139. wonder what xxx does" might yield a simple error box, or it might zap a frame
  140. or soup in your system.
  141.  
  142. At the same time, given the litigious nature of our society that yearns for
  143. risk without responsibility, I feel compelled to add the following warning
  144. (repeated in other variations several places later):
  145.  
  146.   >>> WARNING: USE THIS PACKAGE AT YOUR OWN RISK! <<<
  147.  
  148. =====
  149.  
  150. NewtonScript
  151.  
  152. Syntax
  153. If you have already tried the examples and expressions outlined in under
  154. Exploring Application or Turtle, looked at the examples applic0.nwt,
  155. applic2.nwt and graphic0.nwt, then you should have a rough idea of what
  156. NewtonScript (NS) syntax is like and several of Newt's commands. In NS,
  157. programs or scripts are defined as "methods" on objects. Methods describe an
  158. object's behavior or actions. Objects in NS are called "frames" (perhaps they
  159. should have been called "newtrons"), which inherit attributes and behavior
  160. from other frames, usually called "prototypes". Newt is a prototype or kind
  161. of view. You tell Newt to do things by sending it a "message", e.g., go. This
  162. message consists of a frame (Newt implicitly), a colon (:) separator, the
  163. method name, and parentheses with zero or more parameters (values for
  164. variables) separated by commas. For example, :go(50). A frame also has
  165. "slots" (named attributes) that contain values that you can access, such as
  166. times, dist, and deg. You can just use the slot name if it can be found via
  167. inheritance, or frame.slot if you want to be more specific.
  168.  
  169. WARNING: IF YOU USE OTHER SYSTEM FRAMES, METHODS, AND FUNCTIONS BEYOND THE
  170. ONES I HAVE DESCRIBED HERE, IN MANUAL, AND IN EXAMPLE FILES, YOU DO SO AT
  171. YOUR OWN RISK.
  172.  
  173. For further information on NewtonScript syntax and view frame slots and
  174. methods, NTK from APDA includes manuals, and other books will be published.
  175. The Newt Manual provides a summary of syntax and built-in functions, along
  176. with additional Newt methods for registered users.
  177.  
  178. Errors
  179.  
  180. In the unlikely event that an error occurs during Eval or Save, Newt pops up a
  181. helpful error message and/or cryptic code. You can add another plug-in (ErrCnst)
  182. that provides a complete list of error message. There is a Newton book
  183. (newton.uiowa.edu/newton/software/books/error-book.hqx) that lists errors
  184. from the NTK docs. If you have a Macintosh, the Newton LowDown DA
  185. (newton.uiowa.edu/newton/software/hqx/misc/lowdown-da.hqx) may be useful.
  186.  
  187. Things to try: check your syntax against those in examples, check spelling for
  188. method and variable names, missing or extra punctuation or values, garbage
  189. from stray gestures, check number and type of arguments (e.g., float vs.
  190. integer), and in general use your "newtle". If you think it is really a
  191. problem with Newt, send me mail describing what you had entered, and I will
  192. try to respond asap.
  193.  
  194. The 80+ page manual provides basic coverage of NewtonScript syntax and many
  195. built-in functions. It also documents methods for creating applications,
  196. customizing Newt, drawing with it, and accessing other system functionality.
  197. Description and examples of specific system prototypes are provided in
  198. separate files (see examples.txt).
  199.  
  200. =====
  201. Personal History
  202.  
  203. I first implemented a screen turtle on an IMLAC display computer, accessed
  204. from BBN Logo on a DEC PDP-10 at Stanford circa 1973. Subsequently, I
  205. implemented other versions in Lisp, and used others in Smalltalk and
  206. ObjectLogo. My long-time interests in children, learning and programming
  207. environments, plus two small NTK examples, Dot2Dot and InspectorGadget, with
  208. a little creative juxtaposition, started me down this path. Experience with
  209. using and implementing object-oriented browsers and toolkits in Smalltalk and
  210. Lisp and numerous user requests led to the Newt 2.x enhancements to support
  211. application development. When I am not working on Newt at home or trying to
  212. have a life, I am consulting, currently for pharmaceutical companies, on
  213. "enabling technologies", in particular, pen-based systems.
  214.  
  215. Credits
  216.  
  217. Newt 3.1 was developed with NTK 1.5.1; some parts (plug-ins) of Newt were
  218. developed with New itself. Newton and Newton ToolKit are trademarks of Apple
  219. Computer. Kudos to Apple for creating an exciting product (Newton), and
  220. powerful object-oriented language (NewtonScript) and development environment
  221. (NTK). I look forward to new versions of NTK, documentation and examples. 
  222. Manual created with FrameMaker 4.0 (from Frame Technology); electronic
  223. version with Acrobat 2.0 (from Adobe), and various Newtonbook versions using
  224. BookMaker.
  225.  
  226. My family contributed the evening and weekend time for me to explore this;
  227. Ellie and Kristina helped with testing, Maria with proofreading. Finally,
  228. thanks to the users and testers who have given me feedback and encouragement.
  229. I hope that Newt can continue to evolve into an environment that meets your
  230. needs.
  231.  
  232.